home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3n / inet.z / inet
Encoding:
Text File  |  1998-10-20  |  8.1 KB  |  130 lines

  1.  
  2.  
  3.  
  4. iiiinnnneeeetttt((((3333NNNN))))                                                              iiiinnnneeeetttt((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _iiii_nnnn_eeee_tttt: _iiii_nnnn_eeee_tttt______aaaa_dddd_dddd_rrrr, _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_wwww_oooo_rrrr_kkkk, _iiii_nnnn_eeee_tttt______mmmm_aaaa_kkkk_eeee_aaaa_dddd_dddd_rrrr, _iiii_nnnn_eeee_tttt______llll_nnnn_aaaa_oooo_ffff, _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_oooo_ffff,
  10.      _iiii_nnnn_eeee_tttt______nnnn_tttt_oooo_aaaa - Internet address manipulation
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_oooo_cccc_kkkk_eeee_tttt_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_nnnn_eeee_tttt_iiii_nnnn_eeee_tttt_////_iiii_nnnn_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_aaaa_rrrr_pppp_aaaa_////_iiii_nnnn_eeee_tttt_...._hhhh_>>>>
  17.      _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg _iiii_nnnn_eeee_tttt______aaaa_dddd_dddd_rrrr_((((_cccc_hhhh_aaaa_rrrr _****_cccc_pppp_))))_;;;;
  18.      _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_wwww_oooo_rrrr_kkkk_((((_cccc_hhhh_aaaa_rrrr _****_cccc_pppp_))))_;;;;
  19.      _ssss_tttt_rrrr_uuuu_cccc_tttt _iiii_nnnn______aaaa_dddd_dddd_rrrr _iiii_nnnn_eeee_tttt______mmmm_aaaa_kkkk_eeee_aaaa_dddd_dddd_rrrr_((((_iiii_nnnn_tttt _nnnn_eeee_tttt_,,,, _iiii_nnnn_tttt _llll_nnnn_aaaa_))))_;;;;
  20.      _iiii_nnnn_tttt _iiii_nnnn_eeee_tttt______llll_nnnn_aaaa_oooo_ffff_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _iiii_nnnn______aaaa_dddd_dddd_rrrr _iiii_nnnn_))))_;;;;
  21.      _iiii_nnnn_tttt _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_oooo_ffff_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _iiii_nnnn______aaaa_dddd_dddd_rrrr _iiii_nnnn_))))_;;;;
  22.      _cccc_hhhh_aaaa_rrrr _****_iiii_nnnn_eeee_tttt______nnnn_tttt_oooo_aaaa_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _iiii_nnnn______aaaa_dddd_dddd_rrrr _iiii_nnnn_))))_;;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      The routines _iiii_nnnn_eeee_tttt______aaaa_dddd_dddd_rrrr and _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_wwww_oooo_rrrr_kkkk each interpret character strings
  26.      representing numbers expressed in the Internet standard `_....'  notation,
  27.      returning numbers suitable for use as Internet addresses and Internet
  28.      network numbers, respectively.  The routine _iiii_nnnn_eeee_tttt______mmmm_aaaa_kkkk_eeee_aaaa_dddd_dddd_rrrr takes an
  29.      Internet network number and a local network address and constructs an
  30.      Internet address from it.  The routines _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_oooo_ffff and _iiii_nnnn_eeee_tttt______llll_nnnn_aaaa_oooo_ffff break
  31.      apart Internet host addresses, returning the network number and local
  32.      network address part, respectively.
  33.  
  34.      The routine _iiii_nnnn_eeee_tttt______nnnn_tttt_oooo_aaaa returns a pointer to a string in the base 256
  35.      notation "_d_...._d_...._d_...._d_"""" _dddd_eeee_ssss_cccc_rrrr_iiii_bbbb_eeee_dddd _bbbb_eeee_llll_oooo_wwww_....
  36.  
  37.      All Internet addresses are returned in network order (bytes ordered from
  38.      left to right).  All network numbers and local address parts are returned
  39.      as machine format integer values.
  40.  
  41. IIIINNNNTTTTEEEERRRRNNNNEEEETTTT AAAADDDDDDDDRRRREEEESSSSSSSSEEEESSSS
  42.      Values specified using the `_....'  notation take one of the following forms:
  43.  
  44.  
  45.           _aaaa_...._bbbb_...._cccc_...._dddd
  46.           _aaaa_...._bbbb_...._cccc
  47.           _aaaa_...._bbbb
  48.           _aaaa
  49.  
  50.      When four parts are specified, each is interpreted as a byte of data and
  51.      assigned, from left to right, to the four bytes of an Internet address.
  52.  
  53.      When a three part address is specified, the last part is interpreted as a
  54.      16-bit quantity and placed in the right most two bytes of the network
  55.      address.  This makes the three part address format convenient for
  56.      specifying Class B network addresses as "128.net.host".
  57.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. iiiinnnneeeetttt((((3333NNNN))))                                                              iiiinnnneeeetttt((((3333NNNN))))
  68.  
  69.  
  70.  
  71.      When a two part address is supplied, the last part is interpreted as a
  72.      24-bit quantity and placed in the right most three bytes of the network
  73.      address.  This makes the two part address format convenient for
  74.      specifying Class A network addresses as "net.host".
  75.  
  76.      When only one part is given, the value is stored directly in the network
  77.      address without any byte rearrangement.
  78.  
  79.      All numbers supplied as "parts" in a `_....'  notation may be decimal, octal,
  80.      or hexadecimal, as specified in the C language (that is, a leading 0x or
  81.      0X implies hexadecimal; otherwise, a leading 0 implies octal; otherwise,
  82.      the number is interpreted as decimal).
  83.  
  84. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.      _gggg_eeee_tttt_hhhh_oooo_ssss_tttt_eeee_nnnn_tttt(3N), _gggg_eeee_tttt_nnnn_eeee_tttt_eeee_nnnn_tttt(3N), _hhhh_oooo_ssss_tttt_ssss(4), _nnnn_eeee_tttt_wwww_oooo_rrrr_kkkk_ssss(4)
  86.  
  87. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  88.      The value -1 is returned by _iiii_nnnn_eeee_tttt______aaaa_dddd_dddd_rrrr and _iiii_nnnn_eeee_tttt______nnnn_eeee_tttt_wwww_oooo_rrrr_kkkk for malformed
  89.      requests.
  90.  
  91. NNNNOOOOTTTTEEEESSSS
  92.      The problem of host byte ordering versus network byte ordering is
  93.      confusing.  A simple way to specify Class C network addresses in a manner
  94.      similar to that for Class B and Class A is needed.
  95.  
  96.      The return value from _iiii_nnnn_eeee_tttt______nnnn_tttt_oooo_aaaa points to static information which is
  97.      overwritten in each call.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.